// Copyright 2022 a.o.smith ALL Rights Reserved
package com.liuxinlong.modules.butler.service;

import com.liuxinlong.common.ImportResp;
import com.liuxinlong.modules.entity.ButlerTrain;

import javax.servlet.http.HttpServletResponse;
import java.util.List;
import java.util.Map;

/**
 * 培训文档业务接口层
 *
 * @author liuxinlong@hotwater.com.cn
 * @version 1.0.0
 * @since 2022-09-27
 */
public interface ButlerService {
    /**
     * 查询培训文档列表
     *
     * @param queryParam 查询参数
     * @return 培训文档列表
     */
    List<Map<String, Object>> pageTrainInfo(Map<String, Object> queryParam);

    /**
     * 获取培训文档数量
     *
     * @param queryParam 查询参数
     * @return 培训文档数量
     */
    int getTrainInfoCount(Map<String, Object> queryParam);

    /**
     * 新增培训文档信息
     *
     * @param butlerTrain 培训文档信息
     * @param forceFlag   强制更新标识
     */
    void addTrainInfo(ButlerTrain butlerTrain, int forceFlag);

    /**
     * 修改培训文档信息
     *
     * @param butlerTrain 培训文档信息
     * @param forceFlag   强制更新标识
     */
    void updateTrainInfo(ButlerTrain butlerTrain, int forceFlag);

    /**
     * 删除培训文档信息
     *
     * @param id 培训文档信息id
     */
    void deleteTrainInfo(String id);

    /**
     * 导出培训文档信息
     *
     * @param id 培训文档信息id
     */
    void exportTrainInfo(String id, HttpServletResponse response);

    /**
     * 导入数据预处理
     *
     * @param fileName 文件地址
     * @return 预处理数据
     */
    ImportResp importTrainInfo(String fileName);

    /**
     * 批量新增培训文档信息
     *
     * @param dataList 培训文档信息列表
     * @return 失败数据
     */
    ImportResp batchAddTrainInfo(List<ButlerTrain> dataList);

    /**
     * 修改培训文档状态
     *
     * @param id       培训文档信息id
     * @param pushFlag 推送标识
     */
    void updateTrainInfoStatus(String id, int pushFlag);

    /**
     * 记录培训文档点击次数信息
     *
     * @param id 培训文档信息id
     */
    void countClick(String id);

    /**
     * 查询培训信息
     *
     * @param id 培训id
     * @return 培训信息
     */
    Map<String, Object> queryTrainInfo(String id);
}
